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1. About this guide 


Objectives and target audience 
This guide describes how to install and configure the Skrill module on JTL. It assumes that you have an 
existing JTL installation. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 


Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 


Menul > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the JTL module? 


JTLis an eCommerce platform, which provides online merchants with a flexible shopping cart system, as 
well as control over the look-and-feel, content and functionality of their online store. 


JTL has been fully integrated with Skrill’s online payment solution called Quick Checkout. Installing and 
configuring the Skrill Payment Solution module provides a simple, secure and convenient option for 
connecting to Skrill’s online payment processing platform via JTL. 


Skrill customers using JTL have access to a wide range of card and alternative payment methods. 


Signing up for a Skrill account 


Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your JTL backend and start taking payments. 
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3. Installing and configuring JTL 


Secret Word and API Password 

It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill JTL module. The secret word is used to authenticate the data sent back to your 
JTL server after payment. You must obtain the IP address of your JTL server to configure the API/MQlI 
password. You can find this IP address by executing the following command from a command prompt: 


ping <server domain name> 
For example: 


ping example.jtlserver.com 
Pinging example.jtlserver.com [145.76.160.206] with 32 bytes of data: 


Make a note of the set of numbers in the square brackets. This is the IP address. Now you have the IP 
address, you can setup the secret word and API/MQI password as follows: 


Log in to your Skrill merchant account at www.skrill.com 


1 

2. Goto Settings > Developer Settings (Figure 3-1) 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 

4. For each section, specify the IP address(es) or IP address range of your JTL server. This 
prevents payment or money transfer requests from other IP addresses if your secret word 
or API password is compromised. All requests from other IP addresses are denied. Access 
can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 


e Asubnet in CIDR notation (e.g. 192.168.0.0/24) 

5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase 
letter, and 1 number. 
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Skrill API GUIDES ® 











Home Settings 
GY Home Developer Settings 
Configure API and security settings for your wallet account 
ita Transfers 
Bla Bla Wallet 
MR Banking ID: 116404455 
@® Balances Developer Settings : Bla Bla Wallet Hill mam ES tte 2E = PI ba hi 5 25 m 
Ss All Transactions Wallet IP Whitelisting API / MQI / GSR / CVT Management API Documentation 
Q Users 
©) Automated Payment Interface (API) Disabled ©) 
{3 Settings 
Allow requests to the API only from the following IP addresses. 
& Account Settings Your API secure IP addresses: Edit ) ( + Add ) 








3 Developer Settings 
87.120.141.129 


Wallet Label Settings 


© Merchant Information 


(-) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQI only from the following IP addresses. 


Your MQI secure IP addresses: + add ) 


No active secure IP address found 





E) Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 





Your GSR secure IP addresses: 


[E] Set API/MQI Password Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


=) © 


E) SetSecretWord Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


ftings | Privacy Notice | Regulatory Disclosures | Cookie Notice 
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Figure 3-1: Configuring a Secret Word and API/MQI Password 


Download Skrill on your JTL backend 
The next stage of the JTL integration is to configure the JTL module to connect to your Skrill account. 
The steps are as follows: 


Login to JTL backend 

Go to Marketplace 

Type Skrill in the search field 

Click on “Purchase from manufacturer” 


a i a 
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Scroll down and click on “Shopping carts” 

Scroll down to find JTL logo (Figure 3-2) 

Click on JTL until it opens as shown in (Figure 3-2) 
Click on Download plugin 

. Go back to your JTL backend 

10. Click on Plugins from the top menu 

11. Click on Skrill 

12. Select Skrill Settings to configure Skrill (Figure 3-3) 


O MON Hu 
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CICI (2) plentymarkeis epages 


eshop 


JTL SOFTWARE 


DOWNLOAD PLUGIN © 





SIGN UP NOW ©) 


Figure 3-2: Skrill Settings with example values in JTLbackend 


Plugin: Skrill 


Author: Skrill 
Homepage: (4 https://Skrill.com 
Version: 224 


Description: Skrill module. 


Info Skrill settings Orders documentation 


Dealer ID 11223344 

Merchant account (email) merchantemail@gmail.com 

receiver Shop Receipient 

Logo Url merchantshop.com/URL 

Shop Url merchantshop.com/URL 

API password j= — | oeae 

Secret word = = — = —  ssseesseses 

display IFrame v 
Dealer email address merchantemail@gmail.com 


Figure 3-3: Skrill Settings with example values in JTLbackend 


Configure Skrill Settings 


Configure the Skrill Settings as follows: 


1. Enter your Skrill Merchant account ID in the Merchant ID field. This is the Customer ID of your 
merchant account 


2. Enter your Skrill Merchant account email address 

Enter the API password and Secret word that you set up in the previoussection 

4. Select a display option for the Skrill Payment Form (Iframe or redirect). See Table 3-1 below 
for a detailed explanation of all Skrill settings 


= 
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Either enter a name for your store in the Recipient field to display to customers within the 


Skrill Payment Form 
Optional - Enter a URL of a logo to be displayed on the Skrill Payment Form in place of the 


Recipient text. This URL must be in HTTPS format (begin with https://) 


10 


Table 3-1: Skrill Settings 


Your unique merchant identifier. This is the 58010731 
Customer ID of your merchant account. 


The email address linked to your Skrillmerchant | techpubs@skrill.com 
account (created by you when you first signed up 
for a Skrill merchant account). 


Merchant ID 


Merchant 


Account (email) 


Skrill JTL Module Configuration Guide 1.0 





Logo URL 


Shop URL 
API Password 


Display 





Optional - A description of your shop. This will Demo Shop 
be displayed on the Skrill Payment Form if you 
do not provide a Logo URL. 


Optional - Link to the URL of a logo, to be https://www.skrill.com/ 
displayed on the Skrill Payment Form. Must be in | fileadmin/content/pdf/ 
HTTPS format. acme.png 


URL for the home page of your shop without the | https://myshop.com 
index.php e.g. if your shop is located at 

https://myshop.com/index.php you would enter 

https://myshop.com 





The API password. This field is mandatory. It 
allows the JTL server to receive payment 
information. 


ensures the integrity of the data posted back to 
your JTL servers. 





Enter the secret word configured for your Skrill N/A 
account here. This feature is mandatory and 


This setting has two options: IFrame and Redirect | IFrame 
IFrame - when IFrame is enabled the Skrill 
Payment Form is embedded in your shop 
website. See Figure 3-4: for anexample. 
Redirect - when redirect is enabled the 
customer is redirected to the Skrill Payment 
Form. This form is displayed on its own in 
the current browser tab. This option is 
recommended if you plan to display 
Payment Methods which redirect the user 
to an external website such as Klarna, 
Rapid Transfer, etc. 
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& Deutsch Vereinigtes Konigreich 


269.00 © Skrill 





Æp] Skrill ARPID\ mur @ 


Kartennummer 


Ablaufdatum Prüfnummer 
MM || Ju CVV o 


Name des Karteninhabers 


Geben Sıe den Namen exakt wie auf der Karte angegeben ein 





JETZT BEZAHLEN 


Abbrechen 


u Powered by 
Or Skrill 


Figure 3-4: Iframe (embedded) option 
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4. Displaying Payment Methods 
All Cards and Alternative Payment Methods 


This special payment option launches the Skrill Payment Form with multiple tabs showing all the 


supported Payment methods available in the customer’s country . 


@ Deutsch Vereinigtes Konigreich 


269.00 © Skrill 





=p) Skeill ARPID\ mur © 


Mehr Zahloptionen 











Figure 4-1: Multiple log 
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5. Customer Experience 


This section describes the customer’s checkout experience when using the Skrill JTL module. 


Note: We only describe the Checkout process from the payment selection step onwards as the previous 
steps are unchanged. 


The steps are as follows: 
1. Click apayment method from the list of available payment methods (this list depends on the 
customer’s country, the payment options configured for your Skrill account and the payment 
options configured in the Skrill JTL Module 


Skrill 
@ paysafecard 


pay cesh. pay sole 





VISA 


RAPID: 


by Skrill 





Figure 5-1: JTL Checkout Payment selection showing different payment methods 
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2. Enter Payment details in the Skrill Payment Form 


& Deutsch Deutschland 


6.20EUR ° Skrill 


Kartennummer 


Ablaufdatum Früfnummer 


MM || JJ cw | - 


Name des Karteninhabers 
TEST Customer 


Diese Zahlung wird als Skrill Gast-Zahlung verarbeitet und 
unterliegt der Skrill Datenschutzerklärung. 


JETZT BEZAHLEN 


Abbrechen 
Norton’ Powered by 
Se Skrill 


Figure 5-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the 
following screen: 


# Deutsch Deutschland 


6.2 0EUR Skrill 





4 


Erfolgreiche Bezahlung 








rey Powered by 
Or Skrill 
Figure 5-3: Successful Payment 


4. Click Continue to return to the JTL Order Confirmation screen. This screen contains the 
unique order number for this payment 


ft » Bestellvorgang 


Ihre Bestellung ist bei uns eingegangen 


Ihre Bestellung wurde erfolgreich abgeschlossen. 
Sie erhalten in wenigen Augenblicken eine Bestätigungs-E-Mail mit den Bestelldaten. 


Ihre Bestellnummer: 10018 


Ihre gewählte Zahlungsart: Kreditkarte 


Figure 5-4: Order Confirmation in JTL Checkout 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 
footer option on the right). 





© English France 
10.00Eur 
D English France ® English France 
© 

— — 

— Bb = —_ 
=» © — 5 
visa SD 
VISA 
© vsa @D 
Expiry date Security code Expiry date Security code 
MM YY CVV pmm a (ES ES — Expiry date Security code 
MM | YY CVV 
Cardholder name Cardholder name 
First Last First Last Cardholder name 
First Last 
Email address Why ? Email address Why? 
Email address Why? 
PAY NOW PAY NOW 
PAY NOW 
Powered by Porwurad by 
vv“ Nein e 
Skrill KÁ Skrill Powered by Skrill 


Figure 5-5: Reduced Header and Footer Option 
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6. Payment Information 


The JTL module provides payment information in the Order history with information about the 


payment method used for an order. 


Einträge 1-10 von 19 


Bestellnummer: 


Bestellungen 


Bestellnummer Kunde 


10018 Customer 1 


Refunding Payments 


Abgeholt durch 
Versandart Zahlungsart Wawi 
DHL Kreditkarte Nein 


Figure 6-1: Payment Information Example 


The process for Refunding customer payments is as follows: 


1. Click on Plugins 


Select on Skrill 


2. 
3. Goto Order History 
4. 


Locate the transaction which you would like to refund 


Plugin: Skrill 


Author: Skrill 
Homepage: (7 https://Skrill.com 
Version: 223 


Description: Skrill module. 


Info Skrillsettings Orders documentation 


Entry: 1 - 15 of 20 « 2nd 


Order number: 


Orders 


Order Payment 
number customer method 


10019 Customer Credit card 
1 


y 
> 


Payment 
method 
used 


Visa 


Email address of the Skrill 
Transaction ID account 


68c6a002aa68a37923490a3cbd44ea6b 


Figure 6-2: Search for Order 


5. Check that the details are correct 
6. Scroll to the right until you find refund 


Eintrage/Seite 


10 v 


Warensumme Bestelldatum 
6,20 € 21.06.2020 
12:45:04 

* 





Country Order 


Order (ofthe was 
comes issuing placed Goo 
from institute) in tota 


Austria United EUR €6.2 
States 
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7. Select Credit from the menu to refund the transaction (Figure 6-3) 


Country Order 


Order (of the was 
Email address of the Skrill comes issuing placed Goods Payment Order 
Transaction ID account from institute) in total status date action 
68c6a002aa68a37923490a3cbd44ea6b Austria United EUR €6.20 Completed 06/21/2020 
States 13:54:38 





Figure 6-3: Refund Payment 





@ The payment was successfully refunded. 


Figure 6-4: Refunded Payment 
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7. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using these 
card numbers enter an expiry date in the future and a random CVV number. 


Table 7-1: Test Cards 


5438311234567890 





1000001234567890 


Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness@ paysafe.com, so we can provide you with access. 
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